home *** CD-ROM | disk | FTP | other *** search
/ SEX CD-ROM 1 / SEX CD-ROM 1.iso / viewers / qpeg / english / qpeg.doc < prev    next >
Encoding:
Text File  |  1994-03-20  |  14.2 KB  |  319 lines
  1. -----------------------------------------------------------------------------
  2.  
  3.                                Q P E G / 3 8 6
  4.                              ___________________
  5.                              ~^~^~^~^~^~^~^~^~^~
  6.  
  7.       A fast JPEG viewer for MS-DOS.  VGA graphics and 80386+ required.
  8.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  9.             Currently supports JPEG, Targa (TGA), GIF, PCX, BMP.
  10.             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  11.  
  12. Copyright (c) 1993/94 by TBH-Softworx -- all rights reserved
  13.           Oliver Fromme, Klingestr. 2, 38640 Goslar, Germany
  14.           Internet email:  fromme@rz.tu-clausthal.de
  15.  
  16. Version 1.3k of 20-Mar-1994
  17.  
  18. This program is Shareware.  You may copy the unregistered version, use it,
  19. give it to your friends, upload it to a BBS or something similar, under the
  20. following conditions:
  21.  
  22.  * Don't charge any money for it.  If you upload it to a BBS, make sure that
  23.    it can be downloaded free (without paying for downloading it, except
  24.    for usage fees that have to be paid anyway).
  25.  * Only distribute the whole original package, with all the files included.
  26.  * Don't change the files in any way, except:
  27.    You may change the INI, CFG, ASM, and DRV files for private purposes.
  28.    Don't distribute modified versions of these files to others without
  29.    prior permission of the author of QPEG.
  30.  * QPEG may not be part of any commercial product or service without my
  31.    written permission.
  32.  * If you want to include QPEG on a CD-ROM and/or book, please send me
  33.    a free copy of the CD/book (this is not a must, but I would appreciate
  34.    it very much).
  35.  
  36. Distribution of the unregistered shareware version is explicitly desired,
  37. provided that the above conditions are accepted.
  38.  
  39. This software consists of the following files:
  40.  - QPEG.EXE        the main executable file
  41.  - QPEG.INI        initialization file (ASCII text)
  42.  - QPEG.DAT        data file for QPEG (don't modify!)
  43.  - TBHGLOGO.RLE    TBH logo for user interface
  44. Subdirectories ENGLISH (*=K) and DEUTSCH (*=C):
  45.  - QPEG.DO*        the documentation
  46.  - CHANGES.DO*     list of changes from previous versions
  47.  - INSTALL.DO*     how to configure QPEG
  48.  - FAQ.DO*         frequently asked questions
  49.  - REGISTER.DO*    how to register
  50.  - REGISTER.FRM    registration form (English)
  51.  - REGISTER.FOR    registration form (German)
  52. Other subdirectories:
  53.  - CFG\*.CFG       various configuration files
  54.  - CFG\CFG.DOC     description of the configuration file format
  55.  - DRV\*.DRV       various video driver files
  56.  - DRVSRC\*.ASM    source codes for the video drivers
  57.  - DRVSRC\DRV.DOC  description of the video driver file format
  58.  
  59. Text files with a DOK extension are German, those with a DOC extension
  60. are English.
  61. There may also be some example JPEG files.  They are not part of the QPEG
  62. software package.
  63.  
  64. A few warnings, disclaimer etc:
  65.  
  66. IMPORTANT:  Using modes that your hardware (graphics card and/or monitor)
  67. can't handle can damage your hardware!  Be sure to use only supported
  68. modes.  If you come across a mode which looks flickering or unstable
  69. (i.e. the monitor can't hold the picture), abort QPEG immediately and
  70. delete that mode from the configuration file.
  71.  
  72. YOU ARE USING QPEG AT YOUR OWN RISK!  THE AUTHOR (OLIVER FROMME) IS NOT
  73. LIABLE FOR ANY DAMAGE CAUSED BY THE USE OF QPEG OR BY THE INABILITY
  74. TO USE QPEG.  IF YOU ARE NOT SURE ABOUT THIS, OR IF YOU DON'T ACCEPT THIS,
  75. THEN DO NOT USE QPEG!
  76.  
  77. QPEG is inexpensive shareware.  If you continue using it after a trial
  78. period of 30 days, you are encouraged to pay a small registration fee.
  79. (I try to avoid saying that you MUST register, but actually you MUST.)
  80. The registration is valid for all future updates (you'll get a
  81. registration key which makes the delay disappear).  The source code of
  82. the JPEG decoding routines (Pascal and Asm) used by QPEG is also available.
  83. To become a registered user, please print the file REGISTER.FRM and send
  84. it to me with appropriate payment.  Read the file REGISTER.DOC for further
  85. information.
  86.  
  87. All product names mentioned in this software are trademarks or registered
  88. trademarks of their respective owners.
  89.  
  90. "The Graphics Interchange Format(c) is the Copyright property of
  91. CompuServe Incorporated. GIF(sm) is a Service Mark property of
  92. CompuServe Incorporated."
  93.  
  94. -----------------------------------------------------------------------------
  95.  
  96. What is QPEG/386?
  97. ~~~~~~~~~~~~~~~~~
  98.  
  99. QPEG (Quick-jPEG, pronounce "Q-Peg" [kju:peg]) is a viewer for JPEG image
  100. files.  It is about twice as fast as other common JPEG viewers.  Compare
  101. it yourself, you'll be surprised.
  102.  
  103. JPEG (Joint Photographic Experts Group, pronounce "Jay-Peg") is an image file
  104. format which uses a "lossy" compression.  JPEG images (they have usually a
  105. "JPG" file extension) are normally very small and offer better compression
  106. than any other image format.
  107.  
  108. Decoding of JPEG images is a rather complicated process, thus it needs a lot
  109. of computing power and performance.  QPEG takes advantage of the advanced
  110. features of 80386 and 80486 CPUs, and it uses large look-up tables instead of
  111. formulas.  Well, I don't want to get into details.  It's fast, that's all you
  112. could want to know.
  113.  
  114.  
  115. Features
  116. ~~~~~~~~
  117.  
  118.  - It's fast (have I mentioned that before?).
  119.  - Uses advanced features of 80386/486 processors (note, the Cyrix 486DLC
  120.    is only an improved 386 rather than a 486).
  121.  - Nice preview ability which is even faster (lets you quickly browse through
  122.    lots of images, very useful if you're searching for a certain image).
  123.  - Works even with a standard VGA card (320x200x16, 640x480x16, 320x200x256).
  124.  - Supports many SVGA cards (virtually all with VESA capability).
  125.  - Uses truecolor (16M color), hicolor (32K color), 256 color (either
  126.    greyscale or dithered color), and 16 color (dithered greyscale) modes.
  127.  - You can pan across an image which is bigger than the current screen
  128.    resolution (scrolling).  Some XMS and/or EMS memory is needed for this.
  129.  - You can change the resolution without loading/decoding the image again
  130.    (this is restricted to the same color resolution, for example you can't
  131.    switch from hicolor to truecolor without reloading the image).
  132.  - Supports also the following image file formats:
  133.     * GIF:
  134.        + interlaced and non-interlaced
  135.        + GIF87a and GIF89a (87a subset only)
  136.        + displays the first image of a multi-image GIF
  137.     * Targa (TGA):
  138.        + truecolor (15, 16, 24 and 32 bit), greyscaled, or with palette
  139.        + uncompressed or rle compressed (run length encoded)
  140.        + supports all video modes (16, 256, 32K, 64K, 16M)
  141.     * PCX:
  142.        + 1 and 4 bit with standard palette
  143.        + 8 bit with extended palette
  144.        + 24 bit truecolor
  145.     * BMP (Windows)
  146.        + 1 bit monochrome with palette, uncompressed
  147.        + 4 and 8 bit with palette, uncompressed or RLE4/8 compressed
  148.        + 24 bit truecolor, uncompressed
  149.     * BMP (OS/2)
  150.        + 1, 4 and 8 bit with palette, uncompressed
  151.        + 24 bit truecolor, uncompressed
  152.        + also supports the new multi image format (BA-BMP)
  153.  
  154.  
  155. Requirements
  156. ~~~~~~~~~~~~
  157.  
  158.  - 80386 or better CPU (33 MHz minimum recommended), 386SX is sufficient
  159.  - VGA graphics card (SuperVGA recommended, though QPEG will run on any
  160.    standard VGA card)
  161.  - some XMS and/or EMS memory (depending on the size of the images), though
  162.    QPEG will also run without any XMS/EMS, but then you will be unable to
  163.    do any panning/scrolling
  164.  - MS-DOS 5.0
  165.  
  166. A numeric coprocessor is not required.  If present, it will not be used,
  167. because it would not speed up decoding/displaying.
  168.  
  169.  
  170. Using QPEG
  171. ~~~~~~~~~~
  172.  
  173. At first you have to configure QPEG for your video hardware.  Please read
  174. the file INSTALL.DOC for more information.
  175.  
  176. Then just type 'QPEG' to run it.  There are some command line options
  177. (type 'QPEG /?' to get a help message), but they're usually not needed.
  178.  
  179. The graphical user interface of QPEG is rather intuitive, so there is no
  180. need for much documentation.  Press the 'F1' key to get a list of all
  181. keyboard functions.  Hit '?' to get a list of keys that can be used while
  182. viewing an image.  You can quit QPEG at any time by pressing Alt-X.
  183.  
  184. QPEG can also be used as command line viewer (without graphical user
  185. interface).  Type 'QPEG' followed by one or more filenames.
  186. Wildcards ('*' and '?') are allowed, too.
  187.  
  188.  
  189. Restrictions and Bugs
  190. ~~~~~~~~~~~~~~~~~~~~~
  191.  
  192. QPEG can't handle all kinds of JPEG images.  Specifically, it can only decode
  193. files which comply with the JFIF standard.  See 'Technical Information' below
  194. for more details.
  195.  
  196. The maximum image width is 4000 pixel.  QPEG will refuse to decode larger
  197. images.  The image height is not limited, but if it's too large it may not
  198. fit into memory (XMS/EMS), thus you can't see the bottom part when scrolling
  199. down.  If this happens, try to use a video mode with less colors, because it
  200. needs less memory (see FAQ.DOC).  Or buy more memory :-)
  201.  
  202.  
  203. How to get an updated version of QPEG
  204. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  205.  
  206. This version is most probably not the last one.  There are several ways
  207. to get an up-to-date version of QPEG:
  208.  
  209.  - You can get it free by FTP via The Internet.  Of course that's only
  210.    possible if you've got access to The Internet.  You can find QPEG at
  211.    'ftp.tu-clausthal.de' (139.174.2.10) in /pub/msdos/graphics. There's
  212.    also a mail server available at 'mail-server@rz.tu-clausthal.de'
  213.    (send a mail to it containing the single word 'HELP' for more info).
  214.    I also upload QPEG to 'ftp.rahul.net' in /pub/bryanw/pc/jpeg and
  215.    'ftp.wustl.edu' in /pub/MSDOS_UPLOADS/graphics, if possible.
  216.  
  217.  - You can get it free (except for phone costs) via Fidonet or simply by
  218.    modem from the "Cyberbox" (Germany):
  219.       Line 1  2:2426/2030 (0441-391452),  9600-19200bps
  220.       Line 2  2:2426/2031 (0441-9390942), 2400-19200bps
  221.       Line 3  2:2426/2032 (0441-9390943), 2400-19200bps
  222.       Line 4  2:2426/2033 (0441-9390944), 38400-64000bps (ISDN)
  223.    Fidonet users can request the current version of QPEG at the addresses
  224.    above using the magic "QPEG".
  225.    The "Cyberbox" is in Germany, Europe.  Try to avoid long distance calls.
  226.  
  227.  - You'll get the latest version when registering.  See REGISTER.DOC and
  228.    REGISTER.FRM for more information.  The registration is valid for all
  229.    future updates of QPEG.
  230.  
  231.  - You can get an updated version on disk via normal mail, but that costs
  232.    10 $US or 10 DM to cover my expenses.  Before sending me money, make sure
  233.    that there IS an updated version (otherwise you might be disappointed
  234.    because you got the same version you already have).  You can find my mail
  235.    address at the top of this documentation or by entering 'QPEG /?'.
  236.  
  237.  
  238. Future Enhancements
  239. ~~~~~~~~~~~~~~~~~~~
  240.  
  241. As mentioned before, this is probably not the last version of QPEG.
  242. These features are planned for future versions:
  243.  - Support for more image formats, e.g. IFF/ILBM.
  244.  - Slideshow option (preloading images, but panning disabled).
  245.  - Shrinking of big images.
  246.  - Support for 4DOS/NDOS description files.
  247.  - Support for more SVGA cards.  If you've written a working video driver
  248.    that isn't already distributed with QPEG, I would be most grateful if
  249.    you send it to me.
  250.  - More enhancements.  If you have any ideas, wishes, comments etc, please
  251.    let me know.
  252.  
  253.  
  254. Technical Information
  255. ~~~~~~~~~~~~~~~~~~~~~
  256.  
  257. QPEG can decode greyscaled images (containing a single component using h1v1
  258. upsampling) and YCbCr true color images (containing three interleaved
  259. components in a single scan, using either Yh2v2, Yh2v1 or Yh1v1 upsampling
  260. for Y and Ch1v1 for Cb/Cr), covering virtually all JFIF files in use today.
  261.  
  262. QPEG can handle files that contain restart markers, but it will not use them
  263. for error recovery.  QPEG can also display JPEG files which were created
  264. with the 'Adobe Photoshop' (at least version 2.5).
  265.  
  266. The basic JPEG decoding routines are written in pure 386 assembly language,
  267. everything else is written using Borland Pascal 7.0.  I am not using
  268. protected mode, because it would slow down the decoding rather than speeding
  269. it up.  I have linked the JPEG routines into a single easy to use Pascal
  270. unit, which can also be used within other applications.  If you want to
  271. purchase the unit, please read the file REGISTER.DOC for more information.
  272.  
  273. The JPEG unit provides procedures to open and close a JPEG file, read the
  274. file header, and read the image row by row.  It contains routines which
  275. output the lines as 24 bit true color RGB/BGR, 15/16 bit hicolor, 256 color
  276. dithered, 256 color greyscaled, 16 color grayscaled/dithered, and 16 color
  277. greyscaled/dithered for preview (scaled to one eigth or one fourth).
  278.  
  279.  
  280. Equipment used for Development of QPEG
  281. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  282.  
  283. Hardware:
  284.  - intel 80486-DX2/66, 256 Kb cache, 32 Mb RAM, VLB, SIS chipset, AMI BIOS
  285.  - 780 Mb of harddisk space (WD, Quantum, Maxtor), both IDE and SCSI
  286.  - magneto optical disk drive (Fuji), 15 optical disks (2 Gigabytes)
  287.  - CD-ROM drive (Toshiba, doublespin)
  288.  - 250 Mb tape streamer, 5 tapes (1.25 Gigabytes)
  289.  - Cardex Cobra graphics card, Tseng Labs ET4000-W32i chip, 2 Mb, truecolor
  290.  - 15" color SVGA monitor w/ digital control & LCD display
  291.  - Advanced Gravis Ultrasound (GUS) 1 Mb, Soundblaster, 200 W amplifier
  292.  - 16 bit network card, Ethernet NE2000 compatible
  293.  - 400 dpi greyscale scanner
  294.  - HP LaserJet 4L, 2 Mb RAM, Postscript preprocessor
  295.  - NEC P60 dot matrix printer
  296.  - Genius mouse, three buttons
  297.  - Lots of 3.5" HD floppy disks (mainly 3M and Fuji)
  298.  - Printer spooler:
  299.     + intel 80386-DX/33, 64 Kb cache, 8 Mb RAM, ISA, SIS chipset, AMI BIOS
  300.     + 120 Mb harddisk (Conner), IDE
  301.     + Cardex-8 graphics card, Tseng Labs ET4000 chipset, 1 Mb, truecolor
  302.     + 16 bit network card, Ethernet NE2000 compatible
  303.  
  304. Software:
  305.  - Novell DOS 7.0 by Novell
  306.  - Borland Pascal 7.0 by Borland Int.
  307.  - Turbo Assembler 3.2 by Borland Int.
  308.  - XKEY, KEEP8, BOO by Oliver Fromme
  309.  - PKTINY 1.1 by Thomas Mönkemeier
  310.  - WCED 1.8c by Stuart Russell (Wormsoft)
  311.  - TURBODSK 1.1 by Ciriaco García de Celis
  312.  
  313. Special thanks to:
  314.    Thomas Mönkemeier, Lutz Kotoll, Thilo W. Fischer, Rainer Klaffehn,
  315.    Walter Schmies, Stefan Engel, Ben Jos Walbeehm, Uwe Schlenther
  316.    and all of my beta testers!
  317.  
  318. -----------------------------------------------------------------------------
  319.